PropVariantChangeType-Funktion (propvarutil.h)

  • Artikel

Wandelt einen wert, der als PROPVARIANT-Struktur gespeichert ist, in einen äquivalenten Wert eines anderen Variantentyps um.

Syntax

PSSTDAPI PropVariantChangeType(
  [out] PROPVARIANT          *ppropvarDest,
  [in]  REFPROPVARIANT       propvarSrc,
  [in]  PROPVAR_CHANGE_FLAGS flags,
  [in]  VARTYPE              vt
);

Parameter

[out] ppropvarDest

Typ: PROPVARIANT*

Ein Zeiger auf eine PROPVARIANT-Struktur , die nach erfolgreicher Rückgabe dieser Funktion den koercierten Wert und den neuen Typ empfängt.

[in] propvarSrc

Typ: REFPROPVARIANT

Ein Verweis auf die PROPVARIANT-Quellstruktur , die den Wert enthält, der als ursprünglicher Typ ausgedrückt wird.

[in] flags

Typ: PROPVAR_CHANGE_FLAGS

Reserviert, muss 0 sein.

[in] vt

Typ: VARTYPE

Gibt den neuen Typ für den Wert an. In den folgenden Tabellen finden Sie erkannte Typnamen.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-Standardfehlerwert zurück. Wenn die angeforderte Nötigung nicht möglich ist, wird ein Fehler zurückgegeben.

Hinweise

Beachten Sie, dass es sich bei den PROPVARIANT-Quell - und Zielstrukturen um separate Strukturen handeln muss. Sie können die PROPVARIANT-Quelldaten nicht mit den neuen Zieldaten überschreiben. Der Versuch, dies zu tun, führt zu einem Fehler.

PropVariantChangeType konvertiert Werte wie folgt zwischen den folgenden Typen. Zahlen beziehen sich auf Bedingungen, die nach den Tabellen erläutert werden.

VT_LPWSTR VT_BSTR VT_BOOL VT_FILETIME VT_DATE VT_CLSID
VT_LPWSTR Yes Yes Ja Ja (2) Ja (2) Yes
VT_BSTR Yes Yes Ja Ja (2) Ja (2) Yes
VT_BOOL Yes Yes Ja Nein No No
VT_I2 Yes Yes Ja Nein No No
VT_I4 Yes Yes Ja Nein No No
VT_I8 Yes Yes Ja Nein No No
VT_UI2 Yes Yes Ja Nein No No
VT_UI4 Yes Yes Ja Nein No No
VT_UI8 Yes Yes Ja Nein No No
VT_R8 Ja (3) Ja (3) Ja Nein No No
VT_FILETIME Ja (2) Ja (2) Nein Ja Ja Nein
VT_DATE Ja (2) Ja (2) Nein Ja Ja Nein
VT_CLSID Yes Ja Nein No Nein Ja
 
VT_I2 VT_I4 VT_I8 VT_UI2 VT_UI4 VT_UI8 VT_R8
VT_LPWSTR Yes Yes Yes Yes Yes Yes Ja (3)
VT_BSTR Yes Yes Yes Yes Yes Yes Ja (3)
VT_BOOL Yes Yes Yes Yes Yes Yes Yes
VT_I2 Yes Yes Ja Ja (1) Ja (1) Ja (1) Ja (1)
VT_I4 Ja (1) Yes Ja Ja (1) Ja (1) Ja (1) Ja (1)
VT_I8 Ja (1) Ja (1) Ja Ja (1) Ja (1) Ja (1) Ja (1)
VT_UI2 Ja (1) Yes Yes Yes Yes Ja Ja (1)
VT_UI4 Ja (1) Ja (1) Ja Ja (1) Yes Ja Ja (1)
VT_UI8 Ja (1) Ja (1) Ja (1) Ja (1) Ja (1) Ja Ja (1)
VT_R8 Ja (1) Ja (1) Ja (1) Ja (1) Ja (1) Ja (1) Yes
VT_FILETIME No No No No No No No
VT_DATE No No No No No No No
VT_CLSID No No No No No No No
 

Bedingungen

  1. Beim Konvertieren zwischen numerischen Typen schlagen Konvertierungen außerhalb des Bereichs fehl. Für instance ein negativer Vorzeichenwert für einen typ ohne Vorzeichen oder ein Wert ohne Vorzeichen mit 4 Byte größer als 65535 für einen 2-Byte-Typ ohne Vorzeichen.
  2. Beim Konvertieren zwischen Zeichenfolgen und Datumsangaben wird anstelle einer lokalisierten oder "menschenlesbaren" Darstellung ein kanonisches Zeichenfolgenformular verwendet. Das Format lautet "jjjj/mm/tt:hh:mm:ss.fff" (Jahr, Monat, Datum, Stunden, Minuten, Sekunden, Millisekunden). Beachten Sie, dass dies eine geringere Genauigkeit ist, als vom FILETIME-Typ unterstützt wird, aber für die meisten Zwecke ausreichend sein sollte.
  3. Beim Konvertieren zwischen Gleitkommazahlen und Zeichenfolgen wird das Dezimaltrennzeichen des aktuellen Gebietsschemas verwendet. Beachten Sie, dass dies Probleme verursachen kann, wenn diese Werte in Dateien gespeichert werden, die zwischen verschiedenen Gebietsschemas verschoben werden.
Hinweis In Zukunft werden möglicherweise weitere Typen unterstützt.
 
Die Konvertierung zwischen Vektoren (VT_VECTOR) und Arrays (VT_ARRAY) wird in einigen Fällen unterstützt. Wenn es unterstützt wird, muss die Anzahl der Elemente in jedem identisch sein. Ein einwertige Vektor kann in einen Nicht-Vektorwert konvertiert werden, aber ein mehrwertiges Vektor kann nicht in einen Nicht-Vektortyp konvertiert werden.

Die Coercion zwischen Typen erfolgt ohne Rücksicht auf eigenschaftsspezifische Informationen. Eigenschaftenspezifische Coercions sollten mit PSCoerceToCanonicalValue ausgeführt werden. Wenn die Zeichenfolgenform eines Werts für Benutzeroberflächenzwecke erforderlich ist, sollte PSFormatForDisplay außerdem verwendet werden, um den Wert gemäß gebietsschema- und eigenschaftsspezifischen Informationen zu formatieren, anstatt PropVariantChangeType zu verwenden, um den Wert in eine Zeichenfolge zu übertragen.

Beispiele

Im folgenden Codebeispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird veranschaulicht, wie PropVariantChangeType verwendet wird, um einen VT_FILETIME Wert aus einer Zeichenfolge zu initialisieren.

PROPVARIANT propvarString = {0};
                    
HRESULT hr = InitPropVariantFromString(L"2007/01/30:12:00:00.000", &propvarString);
if (SUCCEEDED(hr))
{
    PROPVARIANT propvarFiletime = {0};

    hr = PropVariantChangeType(&propvarFiletime, propvarString, 0, VT_FILETIME);
    if (SUCCEEDED(hr))
    {
        // propvarFiletime now contains the FILETIME representation 
        // of 1/30/2007 12:00 PM
        PropVariantClear(&propvarFiletime);
    }
    PropVariantClear(&propvarString);
}

Anforderungen

Anforderung Wert
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