Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|