UtilStringCopyWithAlloc-Funktion

Die UtilStringCopyWithAlloc-Funktion ordnet eine Quellzeichenfolge zu und kopiert sie.

Syntax

HRESULT UtilStringCopyWithAlloc(
  _Out_ LPWSTR  *Buffer,
  _In_  UINT    BufferMax,
  _In_  LPCWSTR Source
);

Parameter

Puffer [ out]

Typ: LPWSTR *

Der Speicherort, an dem der Zeiger auf den belegten Arbeitsspeicher gespeichert wird. Wenn sie nicht mehr benötigt wird, muss sie mit CoTaskMemFreefreigegeben werden. Dieser Puffer ist immer NULL-terminiert.

BufferMax [ In]

Typ: UINT

Die maximale Anzahl von Zeichen, die aus der Quelle gelesen werden sollen.

Quelle [ In]

Typ: LPCWSTR

Die zu kopierende Zeichenfolge.

Rückgabewert

Typ: HRESULT

Mögliche Rückgabewerte sind u. a. folgende.

Rückgabecode Beschreibung
S _ OK
Der Vorgang wurde erfolgreich ausgeführt.
E _ INVALIDARG
Mindestens ein Parameter wurde nicht ordnungsgemäß bereitgestellt.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
[Windows 8 Nur Desktop-Apps]
Unterstützte Mindestversion (Server)
[Windows Server 2012 Nur Desktop-Apps]
Header
Ndattributils.h

Weitere Informationen

CoTaskMemFree

UtilAssembleStringsWithAlloc

UtilLoadStringWithAlloc