AllocCountedString 函式
注意
從 Windows 10 開始，無法使用網路存取保護平臺
AllocCountedString函式會為以 Null 終止的字串配置記憶體，並在CountedString結構中傳回它。
語法
NAPAPI HRESULT WINAPI AllocCountedString(
_Inout_ CountedString **countedString,
_In_ const WCHAR *string
);
參數
-
countedString [in， out]
-
新配置 CountedString 結構的位址指標。
-
字串 [in]
-
要傳回 countedString中之 Null 終止字串的指標。
傳回值
| 傳回碼 | 描述 |
|---|---|
|
作業已順利完成。 |
|
傳遞了無效的引數。 |
|
系統已用盡虛擬記憶體。 此作業失敗。 |
備註
NAP 系統支援的所有 COM 介面都會使用標準 COM 記憶體管理規則和 COM 記憶體配置器， (CoTaskMemAlloc 和 CoTaskMemFree) ：
- 在 參數中，呼叫端會配置和釋放。
- Out 參數是由被呼叫者所配置，並使用 CoTaskMem釋放呼叫端。
- In/out 參數是由呼叫端所配置、由被呼叫者釋放和重新配置，最後由呼叫端使用 CoTaskMem釋放。
所有用於釋放記憶體的 NAP 函式也會釋放所有內嵌指標。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2008 [僅限傳統型應用程式] |
| 標頭 |
|
| DLL |
|