ISSDataClassification::GetSensitivityClassification

Статья
01/02/2025

Область применения: SQL Server База данных SQL Azure Azure Synapse Analytics

Отвечает за извлечение данных классификации чувствительности для активного набора строк. Дополнительные сведения и пример кода см. в статье Использование классификации данных.

Синтаксис

HRESULT GetSensitivityClassification(
    SENSITIVITYCLASSIFICATION** ppSensitivityClassification);

Аргументы

ppSensitivityClassification[out]
Указатель на указатель структуры SENSITIVITYCLASSIFICATION. Если этот метод не дает результатов или отсутствуют сведения о классификации данных, поставщик не выделяет память и гарантирует, что аргумент ppSensitivityClassification при выводе является пустым указателем.

Значения кода возврата

S_OK
Метод выполнен успешно.

E_INVALIDARG
Аргумент ppSensitivityClassification имел значение NULL.

E_OUTOFMEMORY
OLE DB Driver for SQL Server не удалось выделить достаточный объем памяти для завершения запроса.

Замечания

OLE DB Driver for SQL Server выделяет блок памяти для хранения структуры SENSITIVITYCLASSIFICATION и данных, на которые ссылается эта структура. Когда объекту-получателю больше не нужен доступ к данным классификации, он должен освободить эту память, вызвав метод IMalloc::Free.

Структура SENSITIVITYCLASSIFICATION определяется следующим образом:

typedef struct tagSensitivityClassification
{
    USHORT                     cSensitivityLabels;
    SENSITIVITYLABEL          *rgSensitivityLabels;
    USHORT                     cInformationTypes;
    INFORMATIONTYPE           *rgInformationTypes;
    USHORT                     cColumnSensitivityMetadata;
    COLUMNSENSITIVITYMETADATA *rgColumnSensitivityMetadata;
    SENSITIVITYRANKENUM        eQuerySensitivityRank;
} SENSITIVITYCLASSIFICATION;

Элемент	Description
cSensitivityLabels	Число структур SENSITIVITYLABEL в rgSensitivityLabels.
rgSensitivityLabels	Массив структур SENSITIVITYLABEL.
cInformationTypes	Число структур INFORMATIONTYPE в rgInformationTypes.
rgInformationTypes	Массив структур INFORMATIONTYPE.
cColumnSensitivityMetadata	Число структур COLUMNSENSITIVITYMETADATA в rgColumnSensitivityMetadata.
rgColumnSensitivityMetadata	Массив структур COLUMNSENSITIVITYMETADATA.
eQuerySensitivityRank	Относительный рейтинг чувствительности запроса, который был выполнен для получения набора строк.

Структура SENSITIVITYLABEL определяется следующим образом:

typedef struct tagSENSITIVITYLABEL
{
    LPOLESTR pwszName;
    LPOLESTR pwszId;
} SENSITIVITYLABEL;

Элемент	Description
pwszName	Имя метки конфиденциальности.
pwszId	Идентификатор метки конфиденциальности.

Структура INFORMATIONTYPE определена следующим образом:

typedef struct tagINFORMATIONTYPE
{
    LPOLESTR pwszName;
    LPOLESTR pwszId;
} INFORMATIONTYPE;

Элемент	Description
pwszName	Имя типа сведений.
pwszId	Идентификатор типа сведений.

Структура COLUMNSENSITIVITYMETADATA определяется следующим образом:

typedef struct tagCOLUMNSENSITIVITYMETADATA
{
    SENSITIVITYPROPERTY* rgSensitivityProperties;
    USHORT cSensitivityProperties;
} COLUMNSENSITIVITYMETADATA;

Элемент	Description
cSensitivityProperties	Число структур SENSITIVITYPROPERTY в rgSensitivityProperties.
rgSensitivityProperties	Массив структур SENSITIVITYPROPERTY.

Перечисление SENSITIVITYRANKENUM определяется следующим образом:

typedef enum tagSENSITIVITYRANKENUM
{
    SENSITIVITYRANK_NOT_DEFINED = -1,
    SENSITIVITYRANK_NONE = 0,
    SENSITIVITYRANK_LOW = 10,
    SENSITIVITYRANK_MEDIUM = 20,
    SENSITIVITYRANK_HIGH = 30,
    SENSITIVITYRANK_CRITICAL = 40
} SENSITIVITYRANKENUM;

Структура SENSITIVITYPROPERTY определяется следующим образом:

typedef struct tagSENSITIVITYPROPERTY
{
    SENSITIVITYLABEL* pSensitivityLabel;
    INFORMATIONTYPE* pInformationType;
    SENSITIVITYRANKENUM eSensitivityRank;
} SENSITIVITYPROPERTY;

Элемент	Description
pSensitivityLabel	Указатель на структуру SENSITIVITYLABEL.
pInformationType	Указатель на структуру INFORMATIONTYPE.
eSensitivityRank	Относительный рейтинг чувствительности столбца в рамках данных о каждом столбце.

См. также

ISSDataClassification
Наборы строк

Поделиться через