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 zugeordneten Arbeitsspeicher gespeichert wird. Wenn es nicht mehr benötigt wird, muss es mit CoTaskMemFree freigegeben werden. Dieser Puffer ist immer NULL-endend.

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. die folgenden:

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_INVALIDARG	Mindestens ein Parameter wurde nicht ordnungsgemäß bereitgestellt.

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

Siehe auch

CoTaskMemFree

UtilAssembleStringsWithAlloc

UtilLoadStringWithAlloc