InitVariantFromResource-Funktion (propvarutil.h)

Initialisiert eine VARIANT-Struktur basierend auf einer Zeichenfolgenressource, die in eine ausführbare Datei eingebettet ist.

Syntax

PSSTDAPI InitVariantFromResource(
  [in]  HINSTANCE hinst,
  [in]  UINT      id,
  [out] VARIANT   *pvar
);

Parameter

[in] hinst

Typ: HINSTANCE

Behandeln Sie eine instance des Moduls, dessen ausführbare Datei die Zeichenfolgenressource enthält.

[in] id

Typ: UINT

Ganzzahliger Bezeichner der zu ladenden Zeichenfolge.

[out] pvar

Typ: VARIANT*

Wenn diese Funktion zurückgibt, enthält die initialisierte VARIANT-Struktur .

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Erstellt eine VT_BSTR Variante. Wenn die Ressource nicht vorhanden ist, initialisiert diese Funktion variant als VT_EMPTY und gibt einen Fehlercode zurück.

Beispiele

Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird die Verwendung von InitVariantFromResource veranschaulicht.

// HINSTANCE hinst;
// UINT id;
// Assume variables hinst and id are initialized and valid.
VARIANT var;

HRESULT hr = InitVariantFromResource(hinst, id, &var);

if (SUCCEEDED(hr))
{
    // var now is valid and has type VT_BSTR.
    VariantClear(&var);
}

Anforderungen

Weitere Informationen

InitPropVariantFromResource

InitVariantFromString

LoadString

VariantToString

VariantToStringWithDefault