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 | 要求された処理を実行するには、メモリが不足している。 |