AllocConnections 関数
Note
ネットワーク アクセス保護プラットフォームは、Windows 10以降は使用できません
AllocConnections 関数は、指定した数の Connections 構造体にメモリを割り当てます。
構文
NAPAPI HRESULT WINAPI AllocConnections(
_Inout_ Connections **connections,
_In_ UINT16 connectionsCount
);
パラメーター
-
connections [in, out]
-
新しく割り当てられた Connections 構造体の配列へのポインター。
-
connectionsCount [in]
-
接続に割り当てる構造体の数。
戻り値
リターン コード | 説明 |
---|---|
|
操作が正常に完了しました。 |
|
無効な引数が渡されました。 |
|
システムが仮想メモリ不足です。 この操作は失敗しました。 |
解説
NAP システムでサポートされているすべての COM インターフェイスは、標準の COM メモリ管理規則と COM メモリ アロケーター (CoTaskMemAlloc および CoTaskMemFree) を使用します。
- in パラメーターは、呼び出し元によって割り当てられ、解放されます。
- Out パラメーターは呼び出し先によって割り当てられ、 CoTaskMem を使用して呼び出し元によって解放されます。
- イン/アウト パラメーターは呼び出し元によって割り当てられ、呼び出し先によって解放および再割り当てされ、最終的には CoTaskMem を使用して呼び出し元によって解放されます。
メモリを解放するためのすべての NAP 関数は、すべての埋め込みポインターも解放します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
ヘッダー |
|
[DLL] |
|