IDirectPlay8Address::BuildFromURLW Method

Sets the object equal to the specified Microsoft?DirectPlay??URL string. It erases the contents of the object.

Syntax

HRESULT BuildFromURLW(      

    WCHAR *pwszSourceURL
);

Parameters

pwszSourceURL

[in] Pointer to a NULL-terminated Unicode string that contains a properly formatted DirectPlay address.

Return Value

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

DPNERR_INVALIDPOINTER	Pointer specified as a parameter is invalid.
DPNERR_INVALIDURL	Specified string is not a valid DirectPlayURL.
DPNERR_NOTALLOWED	This function is not allowed on this object.

Remarks

The Dpaddr.h header file defines a number of standard strings that you can use to construct your URL instead using a literal string. All of the string names have the form DPNA_xxx. For example, DPNA_HEADER can be used in place of L"x-directplay:/" for the URL header.