XNetworkingQuerySecurityInformationForUrlAsyncResult

XNetworkingQuerySecurityInformationForUrlAsync 関数から結果を取得します。

構文

HRESULT XNetworkingQuerySecurityInformationForUrlAsyncResult(
         XAsyncBlock* asyncBlock,
         size_t securityInformationBufferByteCount,
         size_t* securityInformationBufferByteCountUsed,
         uint8_t* securityInformationBuffer,
         XNetworkingSecurityInformation** securityInformation
)

パラメーター

asyncBlock _Inout_
型: XAsyncBlock*

XNetworkingQuerySecurityInformationForUrlAsync 関数 に渡された XAsyncBlock へのポインター。

securityInformationBufferByteCount _In_
型: size_t

結果バッファーに対して割り当てるサイズ (バイト単位)。 このデータは、XNetworkingQuerySecurityInformationForUrlAsyncResultSize を呼び出して取得します。 または、大きい結果バッファーを事前に割り当てている場合は、その事前割り当て済みバッファーのサイズを渡すことができます。

securityInformationBufferByteCountUsed_Out_opt_
型: size_t*

実際の結果バッファーのサイズ (バイト単位) へのポインター。

securityInformationBuffer_Out_writes_bytes_to_(securityInformationBufferByteCount,*securityInformationBufferByteCountUsed)
型: uint8_t*

拇印の結果を格納するバッファーへのポインター。

securityInformation_Outptr_
型: XNetworkingSecurityInformation**

ネットワーク セキュリティ許可リスト (NSAL) から返される証明書の拇印の一覧へのポインター。

戻り値

型: HRESULT

HRESULT 成功またはエラー コード。

解説

この関数は、XNetworkingQuerySecurityInformationForUrlAsync 関数から結果を取得します。 このポインターは、結果バッファーに割り当てられるサイズ (バイト単位)、バッファーのバイト サイズの実際の結果、拇印の結果を格納するバッファー、NSAL から返される証明書の拇印のリストを決定します。

バッファーは、セキュリティ情報の構造体ポインター内のすべてのポインターで使用されている基になるバッファーです。 タイトルは、セキュリティ情報の構造体ポインターを使用している限り、バッファーを有効にしておく必要があります。 バッファーを解放してクリーンアップすると、セキュリティ情報の構造体ポインターによって使用されているすべてのメモリもクリーンアップされます。 Microsoft Game Development Kit (GDK) タイトルにあるネットワーク情報については、「ネットワーク情報の取得」を参照してください。

これらのメソッドは、呼び出し元プロセス内のローカル状態を調査して迅速に戻るので、時間に依存するコンテキストから安全に呼び出すことができます。

要件

ヘッダー: XNetworking.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

HTTP と Web ソケット
XNetworkingQuerySecurityInformationForUrlUtf16AsyncResult
XNetworking