IDirectPlay8Address::GetURLA Method

DirectPlay

 
Microsoft DirectX 9.0 SDK Update (Summer 2003)

IDirectPlay8Address::GetURLA Method


Retrieves the Microsoft® DirectPlay® address URL string represented by this object (ANSI version).

Syntax

HRESULT GetURLA(      
    CHAR *pszURL,     PDWORD pdwNumChars );

Parameters

pszURL
[out] Address of a pointer to receive the URL represented by this object. This parameter can be NULL if pdwNumChars points to a DWORD containing 0.
pdwNumChars
[in, out] Pointer to a DWORD that contains the number of characters the specified buffer can hold, including the terminating NULL character. On success this value contains the number of characters written to the specified buffer, including the terminating NULL character. On failure this value contains the number of characters, including the terminating NULL character, required to hold the URL and the method returns DPNERR_BUFFERTOOSMALL.

Return Value

Returns S_OK if successful, or one of the following error values.

DPNERR_BUFFERTOOSMALLThe supplied buffer is not large enough to contain the requested data.
DPNERR_GENERICAn undefined error condition occurred.
DPNERR_INVALIDURLSpecified string is not a valid DirectPlayURL.
DPNERR_OUTOFMEMORYThere is insufficient memory to perform the requested operation.



© 2003 Microsoft Corporation. All rights reserved.