Microsoft DirectX 8.0 (C++) |
接続されているアプリケーションの完全なアプリケーション記述を取得する。
HRESULT GetApplicationDesc( DPN_APPLICATION_DESC *const pAppDescBuffer, DWORD *const pcbDataSize, const DWORD dwFlags );
成功した場合は S_OK を返し、失敗した場合は次のいずれかのエラー値を返す。
DPNERR_BUFFERTOOSMALL |
DPNERR_INVALIDFLAGS |
DPNERR_INVALIDPARAM |
DPNERR_NOCONNECTION |
pAppDescBuffer パラメータに NULL を渡して最初にこのメソッドを呼び出し、必要なバッファ サイズを取得する。2 回目にこのメソッドを呼び出してバッファにデータを格納するときは、構造体の dwSize メンバを適切な値に設定する。
返された DPN_APPLICATION_DESC 構造体には、guidInstance、guidApplication、および pwszSessionName メンバが設定されている。この中には、セッションに接続されているほかのクライアントに関する情報は含まれていない。このような情報は、サーバー アプリケーションのみが取得できる。特に、dwCurrentPlayers メンバは必ず 0 に設定する。
Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
ヘッダー : Dplay8.h で宣言。