Функция StrongNameSignatureGeneration

Статья
08/11/2011

Создает подпись строгого имени для указанной сборки.

Не рекомендуется использовать эту функцию в .NET Framework 4. Вместо этого используйте метод ICLRStrongName::StrongNameSignatureGeneration.

BOOLEAN StrongNameSignatureGeneration ( 
    [in]  LPCWSTR   wszFilePath,
    [in]  LPCWSTR   wszKeyContainer,
    [in]  BYTE      *pbKeyBlob,
    [in]  ULONG     cbKeyBlob,
    [out] BYTE      **ppbSignatureBlob,
    [out] ULONG     *pcbSignatureBlob
);

Параметры

wszFilePath
[in] Путь к файлу, содержащему манифест сборки, для которой будет создана подпись со строгим именем.
wszKeyContainer
[in] Имя контейнера ключей, содержащего пары открытого и закрытого ключей.

Если параметр pbKeyBlob равен NULL, параметр wszKeyContainer должен задавать допустимый контейнер в поставщике служб шифрования (CSP). В данном случае для подписания файла используется пара ключей, хранящихся в контейнере.

Если значение параметра pbKeyBlob не равно NULL, предполагается, что пара ключей расположена в большом двоичном объекте ключей.

Ключи должны быть 1024-разрядными ключами подписи RSA. В настоящее время другие типы ключей не поддерживаются.
pbKeyBlob
[in] Указатель на пару открытого и закрытого ключей. Формат этой пары создается функцией CryptExportKey для Win32. Если значение параметра pbKeyBlob равно NULL, предполагается, что пары ключей содержатся в контейнере ключей, заданном параметром wszKeyContainer.
cbKeyBlob
[in] Размер (в байтах) pbKeyBlob.
ppbSignatureBlob
[out] Указатель на расположение, в которое среда CLR возвращает подпись. Если значение параметра ppbSignatureBlob равно NULL, среда выполнения сохраняет подпись в файле, заданном параметром wszFilePath.

Если значение параметра ppbSignatureBlob не равно NULL, среда CLR выделяет место для возвращения подписи. Вызывающий объект должен освободить это место с помощью функции StrongNameFreeBuffer.
pcbSignatureBlob
[out] Размер возвращаемой подписи (в байтах).

Возвращаемое значение

Значение true, если выполнение успешно, в противном случае — значение false.

Заметки

Чтобы вычислить размер подписи без ее создания нужно задать значение NULL для параметра wszFilePath.

Подпись может храниться непосредственно в файле или возвращаться вызывающим объектом.

Если выполнение функции StrongNameSignatureGeneration не завершилось успешно, нужно вызвать функцию StrongNameErrorInfo для извлечения последней сгенерированной ошибки.

Требования

Платформы: см. раздел Требования к системе для .NET Framework.

Заголовок: StrongName.h

Библиотека: включена как ресурс в MsCorEE.dll

Версии платформы .NET Framework: 4, 3.5 с пакетом обновления 1 (SP1), 3.5, 3.0 с пакетом обновления 1 (SP1), 3.0, 2.0 с пакетом обновления 1 (SP1), 2.0, 1.1, 1.0

См. также

Ссылки

Интерфейс ICLRStrongName

Другие ресурсы

Метод ICLRStrongName::StrongNameSignatureGeneration

Метод ICLRStrongName::StrongNameSignatureGenerationEx

Журнал изменений

Дата	Журнал	Причина
Июль 2010	Добавлена ссылка на рекомендуемый альтернативный способ.	Улучшение информации.

Июль 2010

Добавлена ссылка на рекомендуемый альтернативный способ.

Улучшение информации.

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