InitPropVariantFromResource-Funktion (propvarutil.h)
Initialisiert eine PROPVARIANT-Struktur basierend auf einer Zeichenfolgenressource, die in eine ausführbare Datei eingebettet ist.
Syntax
PSSTDAPI InitPropVariantFromResource(
[in] HINSTANCE hinst,
[in] UINT id,
[out] PROPVARIANT *ppropvar
);
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] ppropvar
Typ: PROPVARIANT*
Wenn diese Funktion zurückgibt, enthält die initialisierte PROPVARIANT-Struktur .
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Funktion erstellt ein VT_LPWSTR Propvariant. Wenn die angegebene Ressource nicht vorhanden ist, initialisiert sie propvariant mit einer leeren Zeichenfolge. Ressourcenzeichenfolgen, die länger als 1024 Zeichen sind, werden abgeschnitten und null beendet.
Beispiele
Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird die Verwendung von InitPropVariantFromResource veranschaulicht.
// HINSTANCE hinst;
// UINT id;
// Assume variables hinst and id are initialized and valid.
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromResource(hinst, id, &propvar);
if (SUCCEEDED(hr))
{
// propvar now is valid and has type VT_LPWSTR.
PropVariantClear(&propvar);
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP mit SP2, Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | propvarutil.h |
| Bibliothek | Propsys.lib |
| DLL | Propsys.dll (Version 6.0 oder höher) |
| Verteilbare Komponente | Windows Desktop Search (WDS) 3.0 |