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 deve essere recuperato il buffer di backup. Può essere NULL.

length

Tipo: [out, facoltativo] UINT32 *

Puntatore facoltativo a un UINT32. Se NULL viene passato per lunghezza, viene ignorato. Se la lunghezza è un puntatore valido a un oggetto UINT32 e la stringa è un HSTRING valido, al completamento della funzione il valore imposta il valore puntato per lunghezza al numero di caratteri Unicode nel buffer di backup per la stringa (inclusi i caratteri Null incorporati, ma esclusi i valori null terminanti null). Se la lunghezza è un puntatore valido a un oggetto UINT32 e la stringa è NULL, il valore puntato a per lunghezza è 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.

Commenti

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

Non modificare il contenuto del buffer: è necessario che un HSTRING sia immutabile.

Requisiti