CheckOutExtension

描述

通过许可管理器检索许可。

许可：

仅在使用浮动版许可的情况下需要 CheckOutExtension；对于所有其他情况，它没有任何影响。使用浮动版许可时，脚本检索到扩展模块许可后，即可使用扩展模块工具。脚本使用完扩展模块中的工具后，应使用 CheckInExtension 函数归还许可，以便其他应用程序使用。当脚本完成时，将归还所有检出的扩展模块许可和设置的产品许可。

语法

CheckOutExtension (extension_code)

参数	说明	数据类型
extension_code	指定要检查的扩展模块产品。 3D —ArcGIS 3D Analyst 扩展模块 Aeronautical —ArcGIS Aviation Charting Airports —ArcGIS Aviation Airports ArcScan —ArcScan Bathymetry —ArcGIS Bathymetry BusinessPrem —ArcGIS Business Analyst DataReviewer —ArcGIS Data Reviewer Desktop DataInteroperability —ArcGIS Data Interoperability extension for Desktop Defense —ArcGIS Defense Mapping Foundation —ArcGIS Production Mapping GeoStats —ArcGIS Geostatistical Analyst 扩展模块 ImageAnalyst —Image Analyst JTX —ArcGIS Workflow Manager (Classic) Desktop LocationReferencing —ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways LocateXT —LocateXT 扩展模块 Nautical —ArcGIS Maritime Network —ArcGIS Network Analyst 扩展模块 Publisher —ArcGIS Publisher Schematics —ArcGIS Schematics 扩展模块 SMPAsiaPacific —StreetMap Premium 亚太地区 SMPEurope —StreetMap Premium 欧洲 SMPJapan —StreetMap Premium 日本 SMPLatinAmerica —StreetMap Premium 拉丁美洲 SMPMiddleEastAfrica —StreetMap Premium 中东和非洲 SMPNorthAmerica —StreetMap Premium 北美洲 Spatial —ArcGIS Spatial Analyst 扩展模块 Tracking —ArcGIS Tracking Analyst 扩展模块 了解有关在 Python 中访问许可和扩展模块的详细信息	String

返回值

数据类型	说明
String	该函数返回指示检出成功或失败的字符串。 NotInitialized —尚未设置任何 Desktop 许可。 Unavailable —申请的许可不存在，无法设置。 CheckedOut —已成功设置许可。

代码示例

CheckOutExtension 示例

检出 ArcGIS 3D Analyst 扩展模块 以供工具使用。

import arcpy
class LicenseError(Exception):
    pass
try:
    if arcpy.CheckExtension("3D") == "Available":
        arcpy.CheckOutExtension("3D")
    else:
        # raise a custom exception
        raise LicenseError
    arcpy.env.workspace = "c:/GrosMorne"
    arcpy.HillShade_3d("WesternBrook", "wbrook_hill", 300)
    arcpy.Aspect_3d("WesternBrook", "wbrook_aspect")
    arcpy.CheckInExtension("3D")
except LicenseError:
    print("3D Analyst license is unavailable")
except arcpy.ExecuteError:
    print(arcpy.GetMessages(2))