CheckOutExtension

描述

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

脚本检索到扩展模块许可后，即可使用扩展模块工具。脚本使用完扩展模块中的工具后，应使用 CheckInExtension 函数将许可归还给 License Manager，以便其他应用程序使用。当脚本完成时，所有检出的扩展模块许可和设置的产品许可都将归还给许可管理器。

说明

提示：

只有在独立脚本中才必须设置产品和扩展模块。如果从 Python 窗口运行工具或者使用脚本工具，产品已在应用程序内进行设置，激活的扩展模块取决于“扩展模块”对话框。

语法

CheckOutExtension (extension_code)

参数	说明	数据类型
extension_code	Keyword for the extension product that is being checked. 3D —ArcGIS 3D Analyst 扩展模块 Aeronautical —ArcGIS for Aviation: Charting Airports —ArcGIS for Aviation: Airports ArcScan —ArcScan Bathymetry —ArcGIS for Maritime: Bathymetry Business —ArcGIS Business Analyst DataReviewer —ArcGIS Data Reviewer for Desktop DataInteroperability —ArcGIS Data Interoperability extension for Desktop Defense —Esri Defense Solution Foundation —Esri Production Mapping GeoStats —ArcGIS Geostatistical Analyst 扩展模块 Highways —Esri Roads and Highways JTX —ArcGIS Workflow Manager for Desktop LocationReferencing —ArcGIS Pipeline Referencing Nautical —ArcGIS for Maritime: Charting Network —ArcGIS Network Analyst 扩展模块 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 扩展模块 Licensing and extensions	String

返回值

数据类型	说明
String	CheckOutExtension 可能会返回以下三个值之一： NotInitialized —尚未设置任何 Desktop 许可。 Unavailable —申请的许可不存在，无法设置。 CheckedOut —已成功设置许可。

代码示例

CheckOutExtension 示例

检出工具所使用的 3D 扩展模块。

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))