IDirectPlay8Address::GetURLW Method

DirectPlay

 
Microsoft DirectX 9.0 SDK Update (Summer 2003)

IDirectPlay8Address::GetURLW Method


Retrieves the Microsoft® DirectPlay® address URL string represented by this object.

Syntax

HRESULT GetURLW(      
    WCHAR *pwszURL,     PDWORD pdwNumChars );

Parameters

pwszURL
[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.