Funzione WindowsGetStringRawBuffer (winstring.h)

Recupera il buffer di backup per la stringa specificata.

Sintassi

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

Parametri

string

Tipo: [in, facoltativo] HSTRING

Stringa facoltativa per cui recuperare il buffer di backup. Può essere NULL.

length

Tipo: [out, facoltativo] UINT32 *

Puntatore facoltativo a un UINT32. Se viene passato NULL per lunghezza, viene ignorato. Se length è un puntatore valido a UINT32 e string è un valore HSTRING valido, al completamento della funzione il valore a cui punta per lunghezza viene impostato sul numero di caratteri Unicode nel buffer di supporto per la stringa (inclusi i caratteri Null incorporati, ma escludendo il valore null di terminazione). Se length è un puntatore valido a UINT32 e string è NULL, il valore a cui punta per lunghezza viene impostato su 0.

Valore restituito

Tipo: PCWSTR

Puntatore al buffer che fornisce l'archivio di backup per la stringa o la stringa vuota se la stringa è NULL o la stringa vuota.

Osservazioni:

Utilizzare la funzione WindowsGetStringRawBuffer per ottenere un puntatore al buffer di backup di un HSTRING.

Non modificare il contenuto del buffer. È necessario che un oggetto HSTRING non sia modificabile.

Requisiti

Requisito	Value
Client minimo supportato	Windows 8 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Header	winstring.h
Library	mincore.lib