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