Microsoft DirectX 8.0 (C++)

IDirectPlay8Address::GetURLA

オブジェクトによって示される Microsoft® DirectPlay® アドレスの URL 文字列を取得する。(ANSI バージョン)

HRESULT GetURLA(
CHAR* pszURL,
PDWORD pdwNumChars
);

パラメータ

pszURL
このオブジェクトが表す URL を受け取るポインタのアドレス。pdwNumChars が 0 を保持する DWORD を示す場合、このパラメータに NULL を指定できる。
pdwNumChars
指定したバッファが保持できる文字数 (NULL ターミネータを含む) を保持する DWORD へのポインタ。成功の場合、この値には指定したバッファに書き込まれた文字数 (NULL ターミネータを含む) が保持される。失敗の場合、この値には URL の保持に必要な文字数 (NULL ターミネータを含む) が保持され、メソッドは DPNERR_BUFFERTOOSMALL を返す。

戻り値

成功した場合は S_OK を返し、失敗した場合は次のいずれかのエラー値を返す。

DPNERR_BUFFERTOOSMALL
DPNERR_GENERIC
DPNERR_INVALIDURL
DPNERR_OUTOFMEMORY

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dpaddr.h で宣言。