次の方法で共有


AllocConnections 関数

Note

ネットワーク アクセス保護プラットフォームは、Windows 10以降は使用できません

AllocConnections 関数は、指定した数の Connections 構造体にメモリを割り当てます。

構文

NAPAPI HRESULT WINAPI AllocConnections(
  _Inout_ Connections **connections,
  _In_    UINT16      connectionsCount
);

パラメーター

connections [in, out]

新しく割り当てられた Connections 構造体の配列へのポインター。

connectionsCount [in]

接続に割り当てる構造体の数。

戻り値

リターン コード 説明
S_OK
操作が正常に完了しました。
E_INVALIDARG
無効な引数が渡されました。
E_OUTOFMEMORY
システムが仮想メモリ不足です。 この操作は失敗しました。

解説

NAP システムでサポートされているすべての COM インターフェイスは、標準の COM メモリ管理規則と COM メモリ アロケーター (CoTaskMemAlloc および CoTaskMemFree) を使用します。

  • in パラメーターは、呼び出し元によって割り当てられ、解放されます。
  • Out パラメーターは呼び出し先によって割り当てられ、 CoTaskMem を使用して呼び出し元によって解放されます。
  • イン/アウト パラメーターは呼び出し元によって割り当てられ、呼び出し先によって解放および再割り当てされ、最終的には CoTaskMem を使用して呼び出し元によって解放されます。

メモリを解放するためのすべての NAP 関数は、すべての埋め込みポインターも解放します。

要件

要件
サポートされている最小のクライアント
Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー
NapUtil.h
[DLL]
Qutil.dll

関連項目

FreeConnections