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
S _ OK
Der Vorgang wurde erfolgreich abgeschlossen.
E _ INVALIDARG
Ein ungültiges Argument wurde übergeben.
E _ OUTOFMEMORY
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
NapUtil.h
DLL
Qutil.dll

Siehe auch

FreeCountedString