|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
GetTokenInformation
The GetTokenInformation function retrieves a specified type of information about an access token. The calling process must have appropriate access rights to obtain the information.
BOOL GetTokenInformation(
HANDLE TokenHandle, // handle of access token TOKEN_INFORMATION_CLASS TokenInformationClass, // type of information to retrieve LPVOID TokenInformation, // address of retrieved information DWORD TokenInformationLength, // size of information buffer PDWORD ReturnLength // address of required buffer size );
Parameters
TokenHandle
Identifies an access token from which information is retrieved.
TokenInformationClass
Specifies a variable of the TOKEN_INFORMATION_CLASS enumerated type identifying the type of information the function retrieves.
TokenInformation
Points to a buffer the function fills with the requested information. The structure put into this buffer depends upon the type of information specified by the TokenInformationClass parameter, as shown in the following list:
Token Information Class Structure Returned TokenUser TOKEN_USER structure. TOKEN_QUERY access is needed to retrieve this information. TokenGroups TOKEN_GROUPS structure. TOKEN_QUERY access is needed to retrieve this information. TokenPrivileges TOKEN_PRIVILEGES structure. TOKEN_QUERY access is needed to retrieve this information. TokenOwner TOKEN_OWNER structure. TOKEN_QUERY access is needed to retrieve this information. TokenPrimaryGroup TOKEN_PRIMARY_GROUP structure. TOKEN_QUERY access is needed to retrieve this information. TokenDefaultDacl TOKEN_DEFAULT_DACL structure. TOKEN_QUERY access is needed to retrieve this information. TokenSource TOKEN_SOURCE structure. TOKEN_QUERY_SOURCE access is needed to retrieve this information. TokenType TOKEN_TYPE enumerated type. TOKEN_QUERY access is needed to retrieve this information. TokenImpersonationLevel SECURITY_IMPERSONATION_LEVEL enumerated type. TOKEN_QUERY access is needed to retrieve this information about a token. If the access token is not an impersonation token, the function fails. TokenStatistics TOKEN_STATISTICS structure. TOKEN_QUERY access is needed to retrieve this information.
The formats for the retrieved structures and enumerated types are listed in the following Remarks section.
TokenInformationLength
Specifies the size, in bytes, of the buffer pointed to by the TokenInformation parameter.
ReturnLength
Points to a variable receiving the actual number of bytes needed for the buffer pointed to by the TokenInformation parameter. If this value is larger than the value specified in the TokenInformationLength parameter, the function fails and stores no data in the buffer. If the value of the TokenInformationClass parameter is TokenDefaultDacl and the token has no default access-control list, the function sets the variable pointed to by ReturnLength to zero and stores no data in the buffer.
Return Values
If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call GetLastError.
See Also
AdjustTokenGroups, AdjustTokenPrivileges, OpenProcessToken, OpenThreadToken, SetTokenInformation, SECURITY_IMPERSONATION_LEVEL, TOKEN_DEFAULT_DACL, TOKEN_GROUPS, TOKEN_INFORMATION_CLASS, TOKEN_OWNER, TOKEN_PRIMARY_GROUP, TOKEN_PRIVILEGES, TOKEN_SOURCE, TOKEN_STATISTICS, TOKEN_TYPE, TOKEN_USER
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
GetTokenInformation
Функция GetTokenInformation извлекает определенный тип информации о признаке доступа. Вызов процесса должен иметь подходящие права доступа, чтобы получать информацию.
BOOL GetTokenInformation(
РУЧКА TokenHandle, // ручка признака доступа TOKEN_INFORMATION_CLASS TokenInformationClass, // типа информации, чтобы извлекать LPVOID TokenInformation, // адрес извлеченной информации DWORD TokenInformationLength, // размера информационного адреса буфера PDWORD ReturnLength // необходимого буферного размера );
Параметры
TokenHandle
Идентифицирует признак доступа из которого информация извлечена.
TokenInformationClass
Определяет переменную TOKEN_INFORMATION_CLASS перечислившую тип, опознающий тип информации функция извлекается.
TokenInformation
Точки на буфер функциональные наполнители запрошенной информацией. Структура помещенная в этот буфер зависит от типа информации определенной параметром TokenInformationClass, как показано в следующем списка:
Возвращанная Символическая Информационная Структура Класса СТРУКТУРА TokenUser TOKEN_USER. доступ TOKEN_QUERY - нужно извлекать эту информацию. СТРУКТУРА TokenGroups TOKEN_GROUPS. доступ TOKEN_QUERY - нужно извлекать эту информацию. СТРУКТУРА TokenPrivileges TOKEN_PRIVILEGES. доступ TOKEN_QUERY - нужно извлекать эту информацию. СТРУКТУРА TokenOwner TOKEN_OWNER. доступ TOKEN_QUERY - нужно извлекать эту информацию. СТРУКТУРА TokenPrimaryGroup TOKEN_PRIMARY_GROUP. доступ TOKEN_QUERY - нужно извлекать эту информацию. СТРУКТУРА TokenDefaultDacl TOKEN_DEFAULT_DACL. доступ TOKEN_QUERY - нужно извлекать эту информацию. СТРУКТУРА TokenSource TOKEN_SOURCE. доступ TOKEN_QUERY_SOURCE - нужно извлекать эту информацию. TokenType TOKEN_TYPE ПЕРЕЧИСЛЯЛ тип. доступ TOKEN_QUERY - нужно извлекать эту информацию. TokenImpersonationLevel SECURITY_IMPERSONATION_LEVEL ПЕРЕЧИСЛЯЛ тип. доступ TOKEN_QUERY - нужно извлекать эту информацию о признаке. Если признак доступа является не признак маскировки, функция терпит неудачу. СТРУКТУРА TokenStatistics TOKEN_STATISTICS. доступ TOKEN_QUERY - нужно извлекать эту информацию.
Форматы для извлеченный структуры и перечислившие типы указаны в секции Замечаний следующего.
TokenInformationLength
Определяет размер, в байтах, буфера указанного, чтобы параметром TokenInformation.
ReturnLength
Точки на переменную, получающие фактическое количество байтов необходимое для буфера указанного, чтобы параметром TokenInformation. Если эта величина большая чем величина определенная в параметре TokenInformationLength, функция терпит неудачу и не загружает никакие данные в буфер. Если величина параметра TokenInformationClass - TokenDefaultDacl и признак не имеет по умолчанию иметь доступ к-управляющему списку, функция устанавливает переменную указанную, чтобы ReturnLength в нуль и не загружает никакие данные в буфер.
Обратные Величины
Если функция добивается успеха, обратная величина ненулевая. Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.
Смотри Также
AdjustTokenGroups, AdjustTokenPrivileges, OpenProcessToken, OpenThreadToken, SetTokenInformation, SECURITY_IMPERSONATION_LEVEL, TOKEN_DEFAULT_DACL, TOKEN_GROUPS, TOKEN_INFORMATION_CLASS, TOKEN_OWNER, TOKEN_PRIMARY_GROUP, TOKEN_PRIVILEGES, TOKEN_SOURCE, TOKEN_STATISTICS, TOKEN_TYPE, TOKEN_USER
|
|
|
|
| |