Microsoft DirectX 8.0 (C++)

IDirectPlay8AddressIP::GetAddress

リモートの DirectPlay 8 IP アドレスからリモート アドレス情報を取得する。成功するには、保持されているアドレスに少なくとも次の要素が含まれている必要がある。

HRESULT GetAddress(
WCHAR* wszAddress,
PDWORD pdwAddressLength,
USHORT* psPort 
);

パラメータ

wszAddress
ホスト名を受け取るバッファへのポインタ。このパラメータを NULL にすると、必要なサイズを取得できる。
pdwAddressLength
wszAddress に指定されるバッファのサイズ (文字単位、NULL ターミネータを含む)。成功した場合、このパラメータには指定されたバッファに書き込まれた文字数が入る (NULL ターミネータを含む)。失敗した場合、このパラメータには、ホスト名の取得に必要な文字数が入る (NULL ターミネータを含む)。
psPort
このローカル アドレスに指定されたポートを保持する USHORT へのポインタ。

戻り値

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

DPNERR_BUFFERTOOSMALL
DPNERR_INVALIDPARAM
DPNERR_INVALIDPOINTER

動作環境

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