GetEntry Method

The GetEntry method gets the configuration information for the specified entry.

IDL Definition

HRESULT GetEntry(
[in]        BSTR  bszName,        /* the entry to get elements for */
[in,out] VARIANT* pbszADsPathPrefix, //VT_BSTR
[in,out] VARIANT* pbszSchema,        //VT_BSTR
[in,out] VARIANT* pbszClass,         //VT_BSTR
[in,out] VARIANT* plSuffix,          //VT_LONG
[in,out] VARIANT* pbszDepObject,     //VT_BSTR
[in,out] VARIANT* pbszDepProp,       //VT_BSTR
[in,out] VARIANT* pbszBindAsName,    //VT_BSTR
[in,out] VARIANT* pbszBindAsPassword //VT_BSTR
) ;

Parameters

bszName

specifies the name of the entry to get configuration information for.

pbszADsPathPrefix

upon return, the VARIANT subtype BSTR (VT_BSTR) variable contains the current ADsPathPrefix value for the specified entry.

pbszSchema

upon return, the VARIANT subtype BSTR (VT_BSTR) variable contains the current Schema value for the specified entry.

pbszClass

upon return, the VARIANT subtype BSTR (VT_BSTR) variable contains the current Class value for the specified entry.

plSuffix

upon return, the VARIANT subtype LONG (VT_I4) variable contains the current Suffix value for the specified entry.

pbszDepObject

upon return, the VARIANT subtype BSTR (VT_BSTR) variable contains the current DepObject value for the specified entry.

pbszDepProp

upon return, the VARIANT subtype BSTR (VT_BSTR) variable contains the current DepProp value for the specified entry.

pbszBindAsName

upon return, the VARIANT subtype BSTR (VT_BSTR) variable contains the current BindAsName value for the specified entry.

pbszBindAsPassword

upon return, the VARIANT subtype BSTR (VT_BSTR) variable contains the current BindAsPassword value for the specified entry.

Return Value

a standard HRESULT value

Remarks

Set bszName to NULL to retrieve information about the default entry.

You must have previously called GetInfo and specified a Membership virtual server instance. If GetInfo has not been called, this method will return an error.

The process invoking this method should have NT administrative credentials associates with it.  If it does not, the method will still succeed, but the pbszBindAsPassword will not be populated with the AUO entry's BindAsPassword value.

Example

' Using Windows Scripting Host and VBScript
'
Option Explicit

' First the AuoConfig object gets instantiated
' using the special creator object
Dim ObjCreator
Set ObjCreator = CreateObject("ObjCreator.ObjCreator.1")

Dim AuoConfig
set AuoConfig = Obj.Creator.CreateObjAuth("MemAdmin.AuoConfig.1")

' Call GetInfo
AuoConfigObjRef.GetInfo(1)
' We want the list of currently defined entries and their providers

Dim Name, Path, Schema, Class, Suffix,DepObj,DepProp,BindAsName,BindAsPassword

Name = ""  ' default entry
AuoConfigObjRef.GetEntry(Name,Path,Schema,Class,Suffix,
DepObj,DepProp,BindAsName,BindAsPassword)

© 1997-1998 Microsoft Corporation. All rights reserved.