Metodo IMFAttributes::GetAllocatedString (mfobjects.h)

Ottiene una stringa di caratteri wide associata a una chiave. Questo metodo alloca la memoria per la stringa.

Sintassi

HRESULT GetAllocatedString(
  [in]  REFGUID guidKey,
  [out] LPWSTR  *ppwszValue,
  [out] UINT32  *pcchLength
);

Parametri

[in] guidKey

GUID che identifica il valore da recuperare. Il tipo di attributo deve essere MF_ATTRIBUTE_STRING.

[out] ppwszValue

Se la chiave viene trovata e il valore è un tipo di stringa, questo parametro riceve una copia della stringa. Il chiamante deve liberare la memoria per la stringa chiamando CoTaskMemFree.

[out] pcchLength

Riceve il numero di caratteri nella stringa, escluso il carattere NULL terminante. Questo parametro non deve essere NULL.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
MF_E_ATTRIBUTENOTFOUND	La chiave specificata non è stata trovata.
MF_E_INVALIDTYPE	Il valore dell'attributo non è una stringa.

Commenti

Per copiare un valore stringa in un buffer allocato dal chiamante, usare il metodo FMAttributes::GetString .

Questa interfaccia è disponibile nelle piattaforme seguenti se i componenti ridistribuibili di Windows Media Format 11 SDK sono installati:

• Windows XP con Service Pack 2 (SP2) e versioni successive.
• Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

Nota Una versione precedente della documentazione ha indicato in modo errato che il parametro pcchLength può essere NULL. L'impostazione di questo parametro su NULL potrebbe avere esito positivo in alcuni casi, ma non è garantita. Il chiamante deve passare un puntatore non NULL per questo parametro.

 

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfobjects.h (include Mfidl.h)
Libreria	Mfuuid.lib

Vedi anche

Attributi e proprietà

FMAttributes

MF_ATTRIBUTE_TYPE