Funzione AllocCountedString
Nota
La piattaforma Protezione accesso alla rete non è disponibile a partire da Windows 10
La funzione AllocCountedString alloca memoria per una stringa con terminazione Null e la restituisce in una struttura CountedString .
Sintassi
NAPAPI HRESULT WINAPI AllocCountedString(
_Inout_ CountedString **countedString,
_In_ const WCHAR *string
);
Parametri
-
countedString [in, out]
-
Puntatore all'indirizzo di una struttura CountedString appena allocata.
-
string [in]
-
Puntatore alla stringa con terminazione Null da restituire in countedString.
Valore restituito
Codice restituito | Descrizione |
---|---|
|
L'operazione è stata completata correttamente. |
|
È stato passato un argomento non valido. |
|
Il sistema non è in memoria virtuale. Questa operazione non è riuscita. |
Commenti
Tutte le interfacce COM supportate dal sistema Protezione accesso alla rete usano regole di gestione della memoria COM standard e gli allocatori di memoria COM (CoTaskMemAlloc e CoTaskMemFree):
- Nei parametri vengono allocati e liberati dal chiamante.
- I parametri out vengono allocati dal chiamato e liberati dal chiamante usando CoTaskMem.
- I parametri in/out vengono allocati dal chiamante, liberati e riallocati dal chiamato e infine liberati dal chiamante, usando CoTaskMem.
Tutte le funzioni protezione accesso alla rete per liberare memoria liberano anche tutti i puntatori incorporati.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato |
Windows Vista [solo app desktop] |
Server minimo supportato |
Windows Server 2008 [solo app desktop] |
Intestazione |
|
DLL |
|