IWICComponentInfo::GetFriendlyName-Methode (wincodec.h)

Ruft den Anzeigenamen der Komponente ab, bei dem es sich um einen lesbaren Anzeigenamen für die Komponente handelt.

Syntax

HRESULT GetFriendlyName(
  [in]      UINT  cchFriendlyName,
  [in, out] WCHAR *wzFriendlyName,
  [out]     UINT  *pcchActual
);

Parameter

[in] cchFriendlyName

Typ: UINT

Die Größe des wzFriendlyName-Puffers .

[in, out] wzFriendlyName

Typ: WCHAR*

Ein Zeiger, der den Anzeigenamen der Komponente empfängt. Das Gebietsschema der Zeichenfolge hängt vom Wert ab, den der Codec zum Zeitpunkt der Installation in die Registrierung geschrieben hat. Für integrierte Komponenten sind diese Zeichenfolgen immer in Englisch.

[out] pcchActual

Typ: UINT*

Ein Zeiger, der die tatsächliche Länge des Anzeigenamens der Komponente empfängt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn cchFriendlyName 0 und wzFriendlyNameNULL ist, wird die erforderliche Puffergröße in pccchActual zurückgegeben.

Anforderungen