PeerDistServerOpenContentInformationEx 関数は、PEERDIST_CONTENTINFO_HANDLEを開きます。 クライアントは、ハンドルを使用してコンテンツ情報を取得します。
構文
DWORD PeerDistServerOpenContentInformationEx(
[in] PEERDIST_INSTANCE_HANDLE hPeerDist,
[in] DWORD cbContentIdentifier,
[in] PBYTE pContentIdentifier,
ULONGLONG ullContentOffset,
ULONGLONG cbContentLength,
[in] PEERDIST_RETRIEVAL_OPTIONS *pRetrievalOptions,
[in, optional] HANDLE hCompletionPort,
[in, optional] ULONG_PTR ulCompletionKey,
[out] PPEERDIST_CONTENTINFO_HANDLE phContentInfo
);
パラメーター
[in] hPeerDist
PeerDistStartup によって返されるPEERDIST_INSTANCE_HANDLE。
[in] cbContentIdentifier
コンテンツ識別子の長さ (バイト単位)。
[in] pContentIdentifier
コンテンツ識別子を含むバッファーへのポインター。
ullContentOffset
コンテンツ情報ハンドルが要求される発行済みコンテンツの先頭からのオフセット。
cbContentLength
コンテンツ情報が要求されるコンテンツ (ullContentOffset から始まる) の長さ (バイト単位)。
[in] pRetrievalOptions
コンテンツ情報を取得するための追加オプションを指定する PEER_RETRIEVAL_OPTIONS 構造体。
[in, optional] hCompletionPort
非同期関数の完了通知を取得するために使用される完了ポートへのハンドル。 完了ポートを作成するには、 CreateIoCompletionPort 関数を使用します。 このパラメーターには NULL を指定できます。
[in, optional] ulCompletionKey
GetQueuedCompletionStatus 関数の lpCompletionKey パラメーターを使用して返される値。 hCompletionPort が NULL の場合、このパラメーターは無視されます。
[out] phContentInfo
コンテンツ情報を取得するために使用されるハンドル。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS。
注釈
関数が成功した場合、 phContentInfo で受け取ったハンドルを
コンテンツ情報を取得するための PeerDistServerRetrieveContentInformation 関数。
このハンドルは PeerDistServerCloseContentInformation 関数を使用して閉じる必要があります。
ullContentOffset と cbContentLength の両方がゼロの場合、コンテンツ全体のコンテンツ情報が取得されます。
pRetrievalOptions パラメーターを使用して、要求側クライアントが処理するように構成されているコンテンツ情報バージョンの範囲を指定できます。 これにより、クライアントは該当するバージョンのコンテンツ情報構造を取得できます。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の | ウィンドウズ |
| Header | peerdist.h |
| Library | PeerDist.lib |
こちらも参照ください
PeerDistServerCloseContentInformation