如何使用SAFEARRAY的BSTR类型来显示VARIANT中的值

Question

我正在开发一个COM对象库，其中有一个函数返回带有SAFEARRAY的VARIANT。如何显示来自此VARIANT实例的值并将其保存在TStringList中？我尝试过在网上搜索但没有找到明确的答案。

我尝试了以下方法但没有成功：

Variant V;
String mystr;

VarClear(V);
TVarData(V).VType = varOleStr;
V = ComFunction->GetValues();  //<<<<----- V is empty
mystr = (wchar_t *)(TVarData(V).VString);
Memo1->Lines->Add(mystr);
VarClear(V);

- Heb

Answer 1

您可以使用TWideStringDynArray并让Delphi进行转换：

procedure LoadStringsFromVariant(const Values: TWideStringDynArray; Strings: TStrings);
var
  I: Integer;
begin
  Strings.BeginUpdate;
  try
    for I := Low(Values) to High(Values) do
      Strings.Add(Values[I]);
  finally
    Strings.EndUpdate;
  end;
end;

当您使用 BSTR 的变体安全数组调用此函数时，它将自动转换为 TWideStringDynArray。不兼容的变体将导致运行时错误 EVariantInvalidArgError。

要检查变体是否包含 BSTR 安全数组，请执行以下操作：

IsOK := VarIsArray(V) and (VarArrayDimCount(V) = 1) and (VarType(V) and varTypeMask = varOleStr);

- Ondrej Kelle

Answer 2

uses ActiveX;

var
  VSafeArray: PSafeArray;
  LBound, UBound, I: LongInt;
  W: WideString;
begin
  VSafeArray := ComFunction.GetValues();
  SafeArrayGetLBound(VSafeArray, 1, LBound);
  SafeArrayGetUBound(VSafeArray, 1, UBound);
  for I := LBound to UBound do
  begin
    SafeArrayGetElement(VSafeArray, I, W);
    Memo1.Lines.Add(W);
  end;
  SafeArrayDestroy(VSafeArray); // cleanup PSafeArray

如果您通过后期绑定（CreateOleObject）创建 ComFunction，则应使用以下内容：

var
  v: Variant;
v := ComFunction.GetValues;
for i := VarArrayLowBound(v, 1) to VarArrayHighBound(v, 1) do
begin 
  W := VarArrayGet(v, [i]);
  Memo1.Lines.Add (W);
end;

- kobik

Answer 3

我该如何显示这个VARIANT实例的值并将其保存在TStringList中？

COM VARIANT结构具有指向SAFEARRAY的指针数据成员parray和pparray，例如：

VARIANT V;
LPSAFEARRAY sa = V_ISBYREF(&V) ? V_ARRAYREF(&V) : V_ARRAY(&V);

另一方面，VCL Variant 类有一个已定义的 LPSAFEARRAY 转换运算符，因此您可以直接赋值（但仅当 Variant.VType 字段没有存在 varByRef 标志时），例如：

Variant V;
LPSAFEARRAY sa = V;

无论哪种方式，一旦您获得了SAFEARRAY指针，就可以使用SafeArray API访问BSTR值，例如：

bool __fastcall VariantToStrings(const Variant &V, TStrings *List)
{
    // make sure the Variant is holding an array
    if (!V_ISARRAY(&V)) return false;

    // get the array pointer
    LPSAFEARRAY sa = V_ISBYREF(&V) ? V_ARRAYREF(&V) : V_ARRAY(&V);

    // make sure the array is holding BSTR values
    VARTYPE vt;
    if (FAILED(SafeArrayGetVartype(sa, &vt))) return false;
    if (vt != VT_BSTR) return false;

    // make sure the array has only 1 dimension
    if (SafeArrayGetDim(sa) != 1) return false;

    // get the bounds of the array's sole dimension
    LONG lBound = -1, uBound = -1;
    if (FAILED(SafeArrayGetLBound(sa, 0, &lBound))) return false;
    if (FAILED(SafeArrayGetUBound(sa, 0, &uBound))) return false;

    if ((lBound > -1) && (uBound > -1))
    {
        // access the raw data of the array
        BSTR *values = NULL;
        if (FAILED(SafeArrayAccessData(sa, (void**)&values))) return false;
        try
        {
            List->BeginUpdate();
            try
            {
                // loop through the array adding the elements to the list
                for (LONG idx = lBound; l <= uBound; ++idx)
                {
                    String s;
                    if (values[idx] != NULL)
                        s = String(values[idx], SysStringLen(values[idx]));
                    List->Add(s);
                }
            }
            __finally
            {
                List->EndUpdate();
            }
        }
        __finally
        {
            // unaccess the raw data of the array
            SafeArrayUnaccessData(sa);
        }
    }

    return true;
}

VarClear(V); TVarData(V).VType = varOleStr;

您完全不需要这些。VCL Variant 类会初始化为一个空状态，因此没有必要赋值 VType，因为您随后会立即将整个 Variant 赋予新值。

V = ComFunction->GetValues(); //<<<<----- V 为空

如果 V 是空的，那么 GetValues() 首先返回的就是一个空的 Variant。

mystr = (wchar_t *)(TVarData(V).VString);

TVarData::VString 是一个 AnsiString& 引用，而不是 wchar_t* 指针。要将 VCL Variant（而不是 COM VARIANT）转换为 String，只需按原样赋值，让 RTL 自动处理细节即可：

String mystr = V;

- Remy Lebeau