Platform SDK: DirectX

DPLMSG_GETPROPERTY

DPLMSG_GETPROPERTY メッセージは、アプリケーションにより、プロパティの現在の値を要求するために送信される。これらのプロパティは、プレーヤーのランキング、プレーヤーを表すビットマップ、またはロビー内で行われたゲームやプレーヤーの初期構成情報などの情報でもある。

typedef struct {
    DWORD   dwType;
    DWORD   dwRequestID;
    GUID    guidPlayer;
    GUID    guidPropertyTag;
} DPLMSG_GETPROPERTY, FAR *LPDPLMSG_GETPROPERTY;
dwType
メッセージを識別する。この値は、DPLSYS_ GETPROPERTY である。
dwRequestID
要求を識別するためにアプリケーションにより生成された ID。ロビーから応答が返されるとき、この要求 ID が設定されている。アプリケーションは、この要求 ID を使用して、応答をペンディング状態の要求と照合できる。
guidPlayer
このプロパティが適用される (適用可能な場合) プレーヤーを識別する GUID。プロパティがプレーヤーに固有でない場合、このメンバには GUID_NULL が設定される。このアプリケーションにより生成されたプレーヤーの GUID は、DPLPROPERTY_PlayerGuid プロパティを要求することによりロビーから取得できる。
guidPropertyTag
要求されたプロパティを識別する GUID。このプロパティは「DirectPlay 定義済みプロパティ」に示している事前に定義された GUID のいずれかであるか、またはアプリケーションやロビーにより追加プロパティに独自の GUID を定義することもできる。」

注意

各プロパティは、GUID (アプリケーション開発者またはロビー開発者により定義される) により識別される。プロパティ要求が行われると、ロビーは DPLMSG_GETPROPERTYRESPONSE メッセージを使用して応答を返す。ロビーは、情報を提供できない場合でも、その情報が使用不可能であることを示すエラーを返す。

アプリケーションでは、応答を待機するのではなく、ペンディング状態の要求が満たされなければそれらを時間切れにすべきである。

必要条件

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : Dplobby.h で宣言。

参照

DPLMSG_GETPROPERTYRESPONSE