The IReadCookie::get_Item method retrieves the specified item from a cookie object.

HRESULT get_Item(
      VARIANT Var,
      VARIANT* pVariantReturn


  • Var
    [in] Contains the name of the item in the collection.

  • pVariantReturn
    [retval] [out] Points to a VARIANT that receives the item value.


If Var is a string, the cookie is assumed to be a dictionary cookie, and Var is treated as the key. If Var is a variant with type VT_ERROR and error code DISP_E_PARAMNOTFOUND, then the cookie is assumed to be a simple cookie and the primary value is returned. (If the cookie is a dictionary, the sequence of key/value pairs are URL-encoded and returned.)

If a dictionary lookup is performed and the item is not found, then pVariantReturn returns VT_EMPTY. Otherwise a VT_BSTR is always returned.


Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

See Also