На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

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


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz