CRegKey::EnumKey

Appelez cette méthode pour énumérer les sous-clés de la clé de Registre ouverte.

LONG EnumKey( 
   DWORD iIndex, 
   LPTSTR pszName, 
   LPDWORD pnNameLength, 
   FILETIME* pftLastWriteTime = NULL  
) throw( );

Paramètres

• iIndex
  L'index de la sous-clé. Ce paramètre doit être égal à zéro pour le premier appel et ensuite être incrémenté pour les appels suivants

• pszName
  Pointeur vers une mémoire tampon qui accepte le nom de la sous-clé, y compris le caractère NULL de fin. Seul le nom de la sous-clé n'est copié dans la mémoire tampon, pas la hiérarchie complète principale.

• pnNameLength
  Pointeur vers une variable qui spécifie la taille, dans TCHARs, de la mémoire tampon spécifiée par le paramètre d' pszName . Cette taille doit inclure le caractère NULL de fin. Lorsque la méthode retourne, la variable pointée pointe vers le pnNameLength contient le nombre de caractères stockés dans la mémoire tampon. Le nombre retourné n'inclut pas le caractère NULL de fin.

• pftLastWriteTime
  Le pointeur à une variable qui accepte le moment où la valeur énumérée a été en dernier entré à.

Valeur de retour

Si la méthode réussit, la valeur de retour est ERROR_SUCCESS. Si la méthode échoue, la valeur de retour est un code d'erreur différent de zéro défini dans WINERROR.H.

Notes

Pour énumérer les sous-clés, appelez CRegKey::EnumKey avec un index de zéro. Incrémentez la valeur d'index et la répétition tant que la méthode retourne ERROR_NO_MORE_ITEMS. Pour plus d'informations, consultez RegEnumKeyEx dans Kit de développement logiciel Windows.

Configuration requise

Header: atlbase.h

Voir aussi

Référence

CRegKey, classe