Freigeben über


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
S_OK
Der Vorgang wurde erfolgreich abgeschlossen.
E_INVALIDARG
Ein ungültiges Argument wurde übergeben.
E_OUTOFMEMORY
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
NapUtil.h
DLL
Qutil.dll

Siehe auch

FreeCountedString