AllocCountedString-Funktion
Hinweis
Die Netzwerkzugriffsschutzplattform ist ab Windows 10
Die AllocCountedString-Funktion weist Arbeitsspeicher für eine null-beendete Zeichenfolge zu und gibt ihn 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 .
-
Zeichenfolge [in]
-
Ein Zeiger auf die NULL-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 verfügt nicht über den virtuellen Arbeitsspeicher. Bei diesem Vorgang ist ein Fehler aufgetreten. |
Bemerkungen
Alle vom NAP-System unterstützten COM-Schnittstellen verwenden standardmäßige COM-Speicherverwaltungsregeln und die COM-Speicherzuordnungen (CoTaskMemAlloc und CoTaskMemFree):
- Parameter werden vom Aufrufer zugeordnet und freigegeben.
- Out-Parameter werden vom Angerufenen zugewiesen und vom Aufrufer mithilfe von CoTaskMem freigegeben.
- Ein-/Aus-Parameter werden vom Aufrufer zugewiesen, vom Aufgerufenen freigegeben und neu zugeordnet und schließlich vom Aufrufer mithilfe von CoTaskMem freigegeben.
Alle NAP-Funktionen zum Freigeben von Arbeitsspeicher geben auch alle eingebetteten Zeiger frei.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
Header |
|
DLL |
|