IDirectPlay8NATResolver::EnumDevices メソッド
IDirectPlay8NATResolver::EnumDevices メソッド
ネットワーク アドレス変換 (NAT) リゾルバを開始できる利用可能なデバイスのリストを列挙する。
構文
HRESULT EnumDevices(
DPN_SERVICE_PROVIDER_INFO *const pSPInfoBuffer,
PDWORD const pdwBufferSize,
PDWORD const pdwNumDevices,
const DWORD dwFlags
);
パラメータ
- pSPInfoBuffer
[out] サービス プロバイダ情報を保持する、DPN_SERVICE_PROVIDER_INFO 構造体の配列へのポインタ。 - pdwBufferSize
[out] pSPInfoBuffer バッファのサイズが格納される DWORD へのポインタ。 - pdwNumDevices
pSPInfoBuffer に返される DPN_SERVICE_PROVIDER_INFO 構造体の数が格納される DWORD へのポインタ。 - dwFlags
[in] 予約済み。NULL に設定すること。
戻り値
成功した場合は DPN_OK を返し、失敗した場合は次のいずれかのエラー値を返す。
DPNERR_BUFFERTOOSMALL | 指定されたバッファが小さすぎて、要求されたデータを格納できない。 |
DPNERR_INVALIDFLAGS | このメソッドに渡されたフラグは無効である。 |
DPNERR_INVALIDOBJECT | Microsoft® DirectPlay® オブジェクトのポインタは無効である。 |
DPNERR_INVALIDPARAM | メソッドに渡された 1 つ以上のパラメータが無効である。 |
DPNERR_UNINITIALIZED | 要求されたオブジェクトが初期化されていない。 |
注意
pdwBufferSize の値により、バッファが小さすぎてデバイスのリストを保持できないことが示されると、必要なサイズは pdwBufferSize に入り、DPNERR_BUFFERTOOSMALL が返される。それ以外の場合、書き込まれるサイズは pdwBufferSize に入る。