IRequest::get_Item

  • Article

The IRequest::get_Item method retrieves a pointer to an interface pointer of the first item in the Request Object object's collections that contains the specified string. The collections are searched in the following order: Request.QueryString Collection, Request.Form Collection, Request.Cookies Collection, Request.ClientCertificate Collection, Request.ServerVariables Collection.

HRESULT get_Item(
      BSTR bstrVar,
      IDispatch** ppObjReturn
);

Parameters

  • bstrVar
    [in] Contains the name of the item to retrieve.

  • ppObjReturn
    [retval] [out] Points to an IDispatch interface pointer that receives the object that contains the value specified in bstrVar.

Return Values

The datatype of the VARIANT that is returned is VT_DISPATCH. If you need to convert the returned item to a BSTR, you should call the Win32 API function VariantChangeType.

If the object containing bstrVar is found in the QueryString, Form, or ServerVariables collection, then ppObjReturn points to an object which supports the IStringList C++ Interface interface.

If the object is found in the Request.ClientCertificate Collection collection, then ppObjReturn points to an object that supports the IRequestDictionary C++ Interface interface.

If the object is found in the Request.Cookies Collection collection, ppObjReturn points to an object which supports the IReadCookie C++ Interface interface.

Requirements

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