AllocCountedString-Funktion
Hinweis
Die Netzwerkzugriffsschutz-Plattform ist ab dem Windows 10
Die AllocCountedString-Funktion reserviert Arbeitsspeicher für eine auf NULL terminierte Zeichenfolge und gibt sie in einer CountedString-Struktur zurück.
Syntax
NAPAPI HRESULT WINAPI AllocCountedString(
_Inout_ CountedString **countedString,
_In_ const WCHAR *string
);
Parameter
-
countedString [ in, out]
-
Ein Zeiger auf die Adresse einer neu zugeordneten CountedString-Struktur.
-
string [ In]
-
Ein Zeiger auf die auf NULL beendete Zeichenfolge, die in countedString zurückgegeben werden soll.
Rückgabewert
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Ein ungültiges Argument wurde übergeben. |
|
Das System befindet sich nicht im virtuellen Arbeitsspeicher. Fehler bei diesem Vorgang. |
Hinweise
Alle vom NAP-System unterstützten COM-Schnittstellen verwenden standardmäßige COM-Speicherverwaltungsregeln und die COM-Speicherzuweisungen (CoTaskMemAlloc und CoTaskMemFree):
- In werden Parameter vom Aufrufer zugeordnet und frei.
- Out-Parameter werden vom Aufrufer zugeordnet und vom Aufrufer mithilfe von CoTaskMem frei.
- Ein-/Aus-Parameter werden vom Aufrufer zugeordnet, vom Aufrufer frei und neu zugeordnet und schließlich vom Aufrufer mithilfe von CoTaskMem frei.
Alle NAP-Funktionen zum Freien von Arbeitsspeicher geben auch alle eingebetteten Zeiger frei.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Header |
|
| DLL |
|