PeerDistServerOpenContentInformationEx 関数 (peerdist.h)
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 の両方が 0 の場合、コンテンツ全体のコンテンツ情報が取得されます。
pRetrievalOptions パラメーターを使用して、要求側クライアントが処理するように構成されているコンテンツ情報バージョンの範囲を指定できます。 これにより、クライアントは適切なバージョンのコンテンツ情報構造を取得できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | peerdist.h |
こちらもご覧ください
PeerDistServerCloseContentInformation