Microsoft DirectX 8.1 (C++)

IDirectPlay8Address::BuildFromURLA

Sets the object equal to the specified in the DirectPlay 8 URL. It erases the contents of the object.

HRESULT BuildFromURLA(
CHAR* pszSourceURL 
);

Parameters

pszSourceURL: [in] Pointer to a NULL-terminated ANSI string that contains a properly formatted DirectPlay 8 address.

Return Values

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

DPNERR_INVALIDPOINTER

DPNERR_INVALIDURL

DPNERR_NOTALLOWED

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.

Requirements

  Windows NT/2000/XP: Available as a redistributable for Windows 2000 and later.
  Windows 98/Me: Available as a redistributable for Windows 98 and later.
  Header: Declared in Dpaddr.h.