IADsPathname::Set, méthode (iads.h)
La méthode IADsPathname::Set configure l’objet Pathname pour l’analyse d’un chemin d’accès au répertoire. Le chemin d’accès est défini avec un format tel que défini dans ADS_SETTYPE_ENUM.
Syntaxe
HRESULT Set(
[in] BSTR bstrADsPath,
[in] long lnSetType
);
Paramètres
[in] bstrADsPath
Chemin d’un objet ADSI.
[in] lnSetType
Option ADS_SETTYPE_ENUM qui définit le type de format à récupérer.
Valeur retournée
Cette méthode prend en charge les valeurs de retour standard, ainsi que les éléments suivants :
Pour plus d’informations et d’autres valeurs de retour, consultez Codes d’erreur ADSI.
Notes
Cette méthode définit l’espace de noms comme spécifié et identifie le fournisseur approprié pour effectuer l’opération de craquage du chemin. La réinitialisation d’un autre espace de noms perdra les données déjà définies par cette méthode.
Exemples
L’exemple de code Visual Basic suivant définit un chemin ADSI complet sur l’objet Pathname.
Dim x As New Pathname
x.Set "LDAP://server/CN=Jeff Smith, DC=Fabrikam, DC=Com", _
ADS_SETTYPE_FULL
dn = x.GetElement(0) ' dn now is "CN=Jeff Smith".
L’exemple de code VBScript/ASP suivant définit un chemin ADSI complet sur l’objet Pathname.
<%
Dim x
const ADS_SETTYPE_FULL = 1
Set x = CreateObject("Pathname")
path = "LDAP://server/CN=Jeff Smith, DC=Fabrikam,DC=com"
x.Set path, ADS_SETTYPE_FULL
dn = x.GetElement(0) ' dn now is "CN=Jeff Smith".
%>
L’exemple de code C++ suivant définit un chemin ADSI complet sur l’objet Pathname.
IADsPathname *pPathname=NULL;
HRESULT hr;
hr = CoCreateInstance(CLSID_Pathname,
NULL,
CLSCTX_INPROC_SERVER,
IID_IADsPathname,
(void**)&pPathname);
if(FAILED(hr))
{
if(pPathname) pPathname->Release();
return NULL;
}
hr = pPathname->Set(CComBSTR("LDAP://CN=pencil/desk"),
ADS_SETTYPE_FULL);
Configuration requise
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | iads.h |
| DLL | Activeds.dll |