énumération ADS_OPTION_ENUM (iads.h)

Article
08/24/2023

Le type d’énumération ADS_OPTION_ENUM contient des valeurs qui indiquent les options qui peuvent être récupérées ou définies avec les méthodes IADsObjectOptions.GetOption et IADsObjectOptions.SetOption .

Syntax

typedef enum __MIDL___MIDL_itf_ads_0001_0077_0001 {
  ADS_OPTION_SERVERNAME = 0,
  ADS_OPTION_REFERRALS,
  ADS_OPTION_PAGE_SIZE,
  ADS_OPTION_SECURITY_MASK,
  ADS_OPTION_MUTUAL_AUTH_STATUS,
  ADS_OPTION_QUOTA,
  ADS_OPTION_PASSWORD_PORTNUMBER,
  ADS_OPTION_PASSWORD_METHOD,
  ADS_OPTION_ACCUMULATIVE_MODIFICATION,
  ADS_OPTION_SKIP_SID_LOOKUP
} ADS_OPTION_ENUM;

Constantes


`ADS_OPTION_SERVERNAME` Valeur : 0 Obtient une VT_BSTR qui contient le nom d’hôte du serveur pour la liaison actuelle à cet objet. Cette option n’est pas prise en charge par le Méthode IADsObjectOptions.SetOption .
`ADS_OPTION_REFERRALS` Obtient ou définit une valeur de VT_I4 qui indique comment la recherche de références est effectuée dans un base de données élastique Cette option peut contenir l’une des valeurs définies par le ADS_CHASE_REFERRALS_ENUM Énumération.
`ADS_OPTION_PAGE_SIZE` Obtient ou définit une valeur VT_I4 qui indique la taille de la page dans une recherche paginée.
`ADS_OPTION_SECURITY_MASK` Obtient ou définit une valeur VT_I4 qui contrôle les données de descripteur de sécurité qui peuvent être lire sur l’objet . Cette option peut contenir n’importe quelle combinaison des valeurs définies dans le ADS_SECURITY_INFO_ENUM énumération.
`ADS_OPTION_MUTUAL_AUTH_STATUS` Obtient une valeur VT_I4 qui détermine si l’authentification mutuelle est effectuée par le Couche SSPI. Si la valeur d’option retournée contient l’indicateur ISC_RET_MUTUAL_AUTH , définie dans Sspi.h, l’authentification mutuelle a été effectuée. Si la valeur de l’option retournée ne contient pas l’indicateur ISC_RET_MUTUAL_AUTH, puis l’authentification mutuelle n’a pas été effectuée. For pour plus d’informations sur l’authentification mutuelle, consultez SSPI. Cette l’option n’est pas prise en charge par le Méthode IADsObjectOptions.SetOption .
`ADS_OPTION_QUOTA` Permet de lire le quota effectif et le quota utilisé d’un principal de sécurité. Cette option prend un VT_BSTR valeur qui contient le principal de sécurité pour lequel les quotas peuvent être lus. Si la chaîne du principal de sécurité est de longueur nulle ou si la valeur est une valeur VT_EMPTY , le principal de sécurité est l’utilisateur actuellement connecté. Cette option est uniquement prise en charge par le Méthode IADsObjectOptions.SetOption .
`ADS_OPTION_PASSWORD_PORTNUMBER` Récupère ou définit une valeur de VT_I4 qui contient le numéro de port utilisé par ADSI pour établir une connexion lorsque le mot de passe est défini ou modifié. Par défaut, ADSI utilise le port 636 pour établir un connexion pour définir ou modifier le mot de passe.
`ADS_OPTION_PASSWORD_METHOD` Récupère ou définit une valeur VT_I4 qui spécifie la méthode d’encodage de mot de passe. Cette option peut contenir l’une des valeurs définies dans le ADS_PASSWORD_ENCODING_ENUM Énumération.
`ADS_OPTION_ACCUMULATIVE_MODIFICATION` Contient une valeur VT_BOOL qui spécifie si les opérations de modification de valeur d’attribut doit être cumulé. Par défaut, lorsqu’une valeur d’attribut est modifiée plusieurs fois, la valeur précédente l’opération de modification est remplacée par l’opération la plus récente. Si cette option est définie sur VARIANT_TRUE, chaque opération de modification de valeur d’attribut est accumulée dans le cache. Lorsque les mises à jour de la valeur d’attribut sont validées sur le serveur avec le Méthode IADs.SetInfo , chaque individu accumulé l’opération est envoyée au serveur. Lorsque cette option a été définie sur VARIANT_TRUE, elle ne peut pas être réinitialisée sur VARIANT_FALSE pour la durée de vie de l’objet ADSI. Pour réinitialiser cette option, tout Les références à l’objet ADSI doivent être libérées et l’objet doit être lié à nouveau. Lorsque l’objet est lié à nouveau, cette option est définie sur VARIANT_FALSE par défaut. Cette option affecte uniquement les valeurs d’attribut modifiées avec le IADs.PutEx et IADsPropertyList.PutPropertyItem Méthodes. Cette option est ignorée par la méthode IADs.Put .
`ADS_OPTION_SKIP_SID_LOOKUP` Si cette option est définie sur l’objet, aucune recherche n’est effectuée (pendant la récupération ou pendant modification). Cette option affecte les IAD et Interfaces IADsPropertyList . Il est également applicable lors de la récupération de l’utilisation effective du quota d’un utilisateur particulier.