IDirectPlay8Address::GetURLA メソッド

IDirectPlay8Address::GetURLA メソッド

このオブジェクトが表す Microsoft® DirectPlay® アドレスの URL 文字列を取得する (ANSI バージョン)。

構文

HRESULT GetURLA(      
    CHAR *pszURL,
    PDWORD pdwNumChars
);

パラメータ

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

戻り値

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

DPNERR_BUFFERTOOSMALL	指定されたバッファが小さすぎて、要求されたデータを格納できない。
DPNERR_GENERIC	定義されていないエラー条件が発生した。
DPNERR_INVALIDURL	指定された文字列は無効な DirectPlayURL である。
DPNERR_OUTOFMEMORY	要求された処理を実行するには、メモリが不足している。