次の方法で共有


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 で終わる文字列へのポインター。

戻り値

リターン コード 説明
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

関連項目

FreeCountedString